home *** CD-ROM | disk | FTP | other *** search
/ Experimental BBS Explossion 3 / Experimental BBS Explossion III.iso / c / wgt35.zip / WGTFLI.DOC < prev    next >
Text File  |  1993-01-28  |  3KB  |  66 lines
  1.             WGT FLI Playing Library
  2.               Copyright 1993 Chris Egerter
  3.  
  4.     This library allows you to play FLI files from AutoDesk's Animator.
  5. While it is playing, you can have sprites moving overtop, resize the
  6. whole FLI as it is playing, perform special effects, and much more.
  7. The FLI player is very versatile, and allows you to do anything with
  8. the flick as it runs. This version reads the FLI file from disk. When
  9. you register, you will receive a version of the library which holds the
  10. fli in memory. This speeds up the animation, at the expense of memory, but
  11. the disk drive won't be going constantly when you play a flick. This means
  12. you could have sprites moving around the screen while an animated FLI
  13. background plays.
  14.  
  15. Using the FLI player is simple. Here are the basic commands:
  16.  
  17.     openfli(char *filename);
  18.        Initializes and verifies FLI file.
  19.        Example: openfli("C:\\tc\\bin\\myfli.fli");
  20.  
  21.     nextframe();
  22.        Loads in the next frame of the FLI onto the virtual screen
  23.        fliscreen. To show the FLI, you must copy the fliscreen to
  24.        the visual screen in some way. (See copyfli).
  25.        Example: nextframe();
  26.  
  27.     copyfli();
  28.        Copies fliscreen to the visual screen. You can also use other
  29.        techniques of showing the FLI. Fliscreen is just a full screen
  30.        block. You can set this to any of your previously allocated
  31.        full screen blocks. You can manipulate the block like any
  32.        other, for special effects. The usual way of showing the FLI
  33.        is copyfli(), but you could also use wresize,wwipe,wfade,
  34.        wwarp, wskew, etc etc.
  35.        Example: copyfli(); // shows FLI
  36.  
  37.        Or try this: wresize(0,0,160,100,fliscreen); // resizes flick
  38.  
  39.      closefli();
  40.        Shuts down the FLI, and closes the file.
  41.        Example: closefli();
  42.  
  43. Variables available to you:
  44.   flickdly: The delay of the current FLI playng.
  45.               It is up to you to make a delay if you wish.
  46.  
  47.   framenumber: The current frame shown.
  48.               NOTE: The first frame is only shown once, and the FLI
  49.            plays one more frame than AA says there is. Once the
  50.            last frame is played, framenumber loops back to frame 2
  51.            even though it looks like frame 1 is being played. This
  52.            is because AA stores an extra frame at the end showing
  53.             the differences between the first and last frames.
  54.  
  55.    flicp1,flicp2,flicp3,flicp4: Defines the last rectangular region which
  56.         changed, and must be copied to the visual screen.           
  57.  
  58.    Maxframe:  The number of frames in the current FLI file.
  59.  
  60. That's all there is to it. It is very simple, yet you can manipulate the
  61. FLI in many ways as it is playing!
  62.  
  63. Note: FLI files have been tested from AutoDesk's Animator, not the Pro
  64. version.
  65.  
  66.